Rename all binaries to be versioned
authorMatthias Clasen <mclasen@redhat.com>
Tue, 18 Oct 2016 14:27:45 +0000 (10:27 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Tue, 18 Oct 2016 14:27:45 +0000 (10:27 -0400)
This is just easier to avoid parallel installation problems.

13 files changed:
docs/reference/gtk/Makefile.am
docs/reference/gtk/gtk-builder-tool.xml [deleted file]
docs/reference/gtk/gtk-docs.sgml
docs/reference/gtk/gtk-encode-symbolic-svg.xml [deleted file]
docs/reference/gtk/gtk-launch.xml [deleted file]
docs/reference/gtk/gtk-query-settings.xml [deleted file]
docs/reference/gtk/gtk-update-icon-cache.xml [deleted file]
docs/reference/gtk/gtk4-builder-tool.xml [new file with mode: 0644]
docs/reference/gtk/gtk4-encode-symbolic-svg.xml [new file with mode: 0644]
docs/reference/gtk/gtk4-launch.xml [new file with mode: 0644]
docs/reference/gtk/gtk4-query-settings.xml [new file with mode: 0644]
docs/reference/gtk/gtk4-update-icon-cache.xml [new file with mode: 0644]
gtk/Makefile.am

index 4d317bb8ce4724733e3ebdee1e85b2403ce460ac..c07a56ef6ad7958164359dc6a9b02ffc1cf003a4 100644 (file)
@@ -290,12 +290,12 @@ content_files =                                   \
        gtk4-demo.xml                           \
        gtk4-icon-browser.xml                   \
        gtk4-widget-factory.xml                 \
-       gtk-builder-tool.xml                    \
-       gtk-encode-symbolic-svg.xml             \
-       gtk-launch.xml                          \
+       gtk4-builder-tool.xml                   \
+       gtk4-encode-symbolic-svg.xml            \
+       gtk4-launch.xml                         \
        gtk4-query-immodules.xml                \
-       gtk-query-settings.xml                  \
-       gtk-update-icon-cache.xml               \
+       gtk4-query-settings.xml                 \
+       gtk4-update-icon-cache.xml              \
        input-handling.xml                      \
        migrating-2to3.xml                      \
        migrating-3xtoy.xml                     \
@@ -497,16 +497,16 @@ EXTRA_DIST += version.xml.in gtk4.types.in
 
 man_MANS =                             \
        gtk4-query-immodules.1          \
-       gtk-update-icon-cache.1         \
-       gtk-encode-symbolic-svg.1       \
-       gtk-launch.1                    \
+       gtk4-update-icon-cache.1        \
+       gtk4-encode-symbolic-svg.1      \
+       gtk4-launch.1                   \
        gtk4-demo.1                     \
        gtk4-demo-application.1         \
        gtk4-widget-factory.1           \
        gtk4-icon-browser.1             \
        broadwayd.1                     \
-       gtk-builder-tool.1              \
-       gtk-query-settings.1
+       gtk4-builder-tool.1             \
+       gtk4-query-settings.1
 
 if ENABLE_MAN
 
diff --git a/docs/reference/gtk/gtk-builder-tool.xml b/docs/reference/gtk/gtk-builder-tool.xml
deleted file mode 100644 (file)
index 375cdb9..0000000
+++ /dev/null
@@ -1,89 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-builder-tool">
-
-<refentryinfo>
-  <title>gtk-builder-tool</title>
-  <productname>GTK+</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk-builder-tool</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk-builder-tool</refname>
-  <refpurpose>GtkBuilder file utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-builder-tool</command>
-<arg choice="opt"><replaceable>COMMAND</replaceable></arg>
-<arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg>
-<arg choice="plain"><replaceable>FILE</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk-builder-tool</command> can perform various operations
-  on GtkBuilder .ui files.
-</para>
-<para>
-  You should always test the modified .ui files produced by gtk-builder-tool
-  before using them in production.
-</para>
-</refsect1>
-
-<refsect1><title>Commands</title>
-  <para>The following commands are understood:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>validate</option></term>
-      <listitem><para>Validates the .ui file and report errors to stderr.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>simplify</option></term>
-      <listitem><para>Simplifies the .ui file by removing properties that
-      are set to their default values and write the resulting XML to stdout.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>enumerate</option></term>
-      <listitem><para>Lists all the named objects that are created in the .ui file.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>preview</option></term>
-      <listitem><para>Preview the .ui file. This command accepts options
-                to specify the ID of an object and a .css file to use.</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-<refsect1><title>Preview Options</title>
-  <para>The <option>preview</option> command accepts the following options:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>--id=<arg choice="plain">ID</arg></option></term>
-      <listitem><para>The ID of the object to preview. If not specified,
-                gtk-builder-tool will choose a suitable object on its own.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>--css=<arg choice="plain">FILE</arg></option></term>
-      <listitem><para>Load style information from the given .css file.</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-</refentry>
index 626ea7d90b49af1391f93e6b82fe71ace1eb16f4..38eb57eee4af049a412d9c7116216ef7040622f6 100644 (file)
     <xi:include href="gtk4-widget-factory.xml" />
     <xi:include href="gtk4-icon-browser.xml" />
     <xi:include href="gtk4-query-immodules.xml" />
-    <xi:include href="gtk-update-icon-cache.xml" />
-    <xi:include href="gtk-encode-symbolic-svg.xml" />
-    <xi:include href="gtk-builder-tool.xml" />
-    <xi:include href="gtk-launch.xml" />
-    <xi:include href="gtk-query-settings.xml" />
+    <xi:include href="gtk4-update-icon-cache.xml" />
+    <xi:include href="gtk4-encode-symbolic-svg.xml" />
+    <xi:include href="gtk4-builder-tool.xml" />
+    <xi:include href="gtk4-launch.xml" />
+    <xi:include href="gtk4-query-settings.xml" />
     <xi:include href="broadwayd.xml" />
   </part>
 
diff --git a/docs/reference/gtk/gtk-encode-symbolic-svg.xml b/docs/reference/gtk/gtk-encode-symbolic-svg.xml
deleted file mode 100644 (file)
index f17e95d..0000000
+++ /dev/null
@@ -1,67 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-encode-symbolic-svg">
-
-<refentryinfo>
-  <title>gtk-encode-symbolic-svg</title>
-  <productname>GTK+</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Alexander</firstname>
-      <surname>Larsson</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk-encode-symbolic-svg</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk-encode-symbolic-svg</refname>
-  <refpurpose>Symbolic icon conversion utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-encode-symbolic-svg</command>
-<arg choice="opt">OPTION...</arg>
-<arg choice="plain"><replaceable>PATH</replaceable></arg>
-<arg choice="plain"><replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk-encode-symbolic-svg</command> converts symbolic svg icons into
-  specially prepared png files. GTK+ can load and recolor these pngs, just like
-  original svgs, but loading them is much faster.
-</para>
-<para>
-  <replaceable>PATH</replaceable> is the name of a symbolic svg file,
-  <replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable> are the
-  desired dimensions for the generated png file.
-</para>
-<para>
-  To distinguish them from ordinary pngs, the generated files have the extension
-  <filename>.symbolic.png</filename>.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-<variablelist>
-  <varlistentry>
-    <term>-o <replaceable>DIRECTORY</replaceable></term>
-    <term>--output <replaceable>DIRECTORY</replaceable></term>
-    <listitem><para>Write png files to <replaceable>DIRECTORY</replaceable>
-         instead of the current working directory.</para></listitem>
-  </varlistentry>
-</variablelist>
-</refsect1>
-
-</refentry>
diff --git a/docs/reference/gtk/gtk-launch.xml b/docs/reference/gtk/gtk-launch.xml
deleted file mode 100644 (file)
index 86ffe6d..0000000
+++ /dev/null
@@ -1,74 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-launch">
-
-<refentryinfo>
-  <title>gtk-launch</title>
-  <productname>GTK+</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Tomáš</firstname>
-      <surname>Bžatek</surname>
-      <email>tbzatek@redhat.com</email>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk-launch</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk-launch</refname>
-  <refpurpose>Launch an application</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-launch</command>
-<arg choice="opt" rep="repeat">OPTION</arg>
-<arg choice="plain">APPLICATION</arg>
-<arg choice="opt" rep="repeat">URI</arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk-launch</command> launches an application using the given name.
-The application is started with proper startup notification on a default
-display, unless specified otherwise.
-</para>
-<para>
-<command>gtk-launch</command> takes at least one argument, the name of
-the application to launch. The name should match application desktop file name,
-as residing in /usr/share/application, with or without the '.desktop' suffix.
-</para>
-<para>
-If called with more than one argument, the rest of them besides the application
-name are considered URI locations and are passed as arguments to the launched
-application.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-  <para>The following options are understood:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>-?</option>, <option>--help</option></term>
-      <listitem><para>Prints a short help text and exits.</para></listitem>
-    </varlistentry>
-  </variablelist>
-  <variablelist>
-    <varlistentry>
-    <term><option>--version</option></term>
-      <listitem><para>Prints the program version and exits.</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-</refentry>
diff --git a/docs/reference/gtk/gtk-query-settings.xml b/docs/reference/gtk/gtk-query-settings.xml
deleted file mode 100644 (file)
index 52f9638..0000000
+++ /dev/null
@@ -1,45 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-query-settings">
-
-<refentryinfo>
-  <title>gtk-query-settings</title>
-  <productname>GTK+</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Timm</firstname>
-      <surname>Bäder</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk-query-settings</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk-query-settings</refname>
-  <refpurpose>Utility to print name and value of all GtkSettings properties</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-query-settings</command>
-<arg choice="opt"><replaceable>PATTERN</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk-query-settings</command> prints both name and value of all properties
-  available in the GtkSettings class. Optionally, you can filter which properties
-  to list by specifying a PATTERN.
-</para>
-</refsect1>
-
-</refentry>
diff --git a/docs/reference/gtk/gtk-update-icon-cache.xml b/docs/reference/gtk/gtk-update-icon-cache.xml
deleted file mode 100644 (file)
index 9c46b5a..0000000
+++ /dev/null
@@ -1,123 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk-update-icon-cache">
-
-<refentryinfo>
-  <title>gtk-update-icon-cache</title>
-  <productname>GTK+</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk-update-icon-cache</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk-update-icon-cache</refname>
-  <refpurpose>Icon theme caching utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk-update-icon-cache</command>
-<arg choice="opt">--force</arg>
-<arg choice="opt">--ignore-theme-index</arg>
-<group>
-  <arg choice="plain">--index-only</arg>
-  <arg choice="plain">--include-image-data</arg>
-</group>
-<arg choice="opt">--source <arg choice="plain"><replaceable>NAME</replaceable></arg></arg>
-<arg choice="opt">--quiet</arg>
-<arg choice="opt">--validate</arg>
-<arg choice="plain"><replaceable>PATH</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk-update-icon-cache</command> creates mmapable cache
-  files for icon themes.
-</para>
-<para>
-  It expects to be given the <replaceable>PATH</replaceable> to a icon theme
-  directory containing an <filename>index.theme</filename>, e.g.
-  <filename>/usr/share/icons/hicolor</filename>, and writes a
-  <filename>icon-theme.cache</filename> containing cached information about
-  the icons in the directory tree below the given directory.
-</para>
-<para>
-  GTK+ can use the cache files created by <command>gtk-update-icon-cache</command>
-  to avoid a lot of system call and disk seek overhead when the application
-  starts. Since the format of the cache files allows them to be mmaped
-  shared between multiple applications, the overall memory consumption is
-  reduced as well.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-<variablelist>
-  <varlistentry>
-    <term>--force</term>
-    <term>-f</term>
-    <listitem><para>Overwrite an existing cache file even if it appears to be
-         uptodate.</para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--ignore-theme-index</term>
-    <term>-t</term>
-    <listitem><para>Don't check for the existence of <filename>index.theme</filename>
-     in the icon theme directory. Without this option, <command>gtk-update-icon-cache</command>
-     refuses to create an icon cache in a directory which does not appear to
-     be the toplevel directory of an icon theme.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--index-only</term>
-    <term>-i</term>
-    <listitem><para>Don't include image data in the cache.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--include-image-data</term>
-    <listitem><para>Include image data in the cache.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--source</term>
-    <term>-c</term>
-    <listitem><para>Output a C header file declaring a constant
-     <replaceable>NAME</replaceable> with the contents of the icon
-     cache.</para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--quiet</term>
-    <term>-q</term>
-    <listitem><para>Turn off verbose output.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--validate</term>
-    <term>-v</term>
-    <listitem><para>Validate existing icon cache.
-    </para></listitem>
-  </varlistentry>
-</variablelist>
-</refsect1>
-
-</refentry>
diff --git a/docs/reference/gtk/gtk4-builder-tool.xml b/docs/reference/gtk/gtk4-builder-tool.xml
new file mode 100644 (file)
index 0000000..b7be944
--- /dev/null
@@ -0,0 +1,89 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-builder-tool">
+
+<refentryinfo>
+  <title>gtk4-builder-tool</title>
+  <productname>GTK+</productname>
+  <authorgroup>
+    <author>
+      <contrib>Developer</contrib>
+      <firstname>Matthias</firstname>
+      <surname>Clasen</surname>
+    </author>
+  </authorgroup>
+</refentryinfo>
+
+<refmeta>
+  <refentrytitle>gtk4-builder-tool</refentrytitle>
+  <manvolnum>1</manvolnum>
+  <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+  <refname>gtk4-builder-tool</refname>
+  <refpurpose>GtkBuilder file utility</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-builder-tool</command>
+<arg choice="opt"><replaceable>COMMAND</replaceable></arg>
+<arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg>
+<arg choice="plain"><replaceable>FILE</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+  <command>gtk4-builder-tool</command> can perform various operations
+  on GtkBuilder .ui files.
+</para>
+<para>
+  You should always test the modified .ui files produced by gtk4-builder-tool
+  before using them in production.
+</para>
+</refsect1>
+
+<refsect1><title>Commands</title>
+  <para>The following commands are understood:</para>
+  <variablelist>
+    <varlistentry>
+    <term><option>validate</option></term>
+      <listitem><para>Validates the .ui file and report errors to stderr.</para></listitem>
+    </varlistentry>
+    <varlistentry>
+    <term><option>simplify</option></term>
+      <listitem><para>Simplifies the .ui file by removing properties that
+      are set to their default values and write the resulting XML to stdout.</para></listitem>
+    </varlistentry>
+    <varlistentry>
+    <term><option>enumerate</option></term>
+      <listitem><para>Lists all the named objects that are created in the .ui file.</para></listitem>
+    </varlistentry>
+    <varlistentry>
+    <term><option>preview</option></term>
+      <listitem><para>Preview the .ui file. This command accepts options
+                to specify the ID of an object and a .css file to use.</para></listitem>
+    </varlistentry>
+  </variablelist>
+</refsect1>
+
+<refsect1><title>Preview Options</title>
+  <para>The <option>preview</option> command accepts the following options:</para>
+  <variablelist>
+    <varlistentry>
+    <term><option>--id=<arg choice="plain">ID</arg></option></term>
+      <listitem><para>The ID of the object to preview. If not specified,
+                gtk4-builder-tool will choose a suitable object on its own.</para></listitem>
+    </varlistentry>
+    <varlistentry>
+    <term><option>--css=<arg choice="plain">FILE</arg></option></term>
+      <listitem><para>Load style information from the given .css file.</para></listitem>
+    </varlistentry>
+  </variablelist>
+</refsect1>
+
+</refentry>
diff --git a/docs/reference/gtk/gtk4-encode-symbolic-svg.xml b/docs/reference/gtk/gtk4-encode-symbolic-svg.xml
new file mode 100644 (file)
index 0000000..3bf2245
--- /dev/null
@@ -0,0 +1,67 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-encode-symbolic-svg">
+
+<refentryinfo>
+  <title>gtk4-encode-symbolic-svg</title>
+  <productname>GTK+</productname>
+  <authorgroup>
+    <author>
+      <contrib>Developer</contrib>
+      <firstname>Alexander</firstname>
+      <surname>Larsson</surname>
+    </author>
+  </authorgroup>
+</refentryinfo>
+
+<refmeta>
+  <refentrytitle>gtk4-encode-symbolic-svg</refentrytitle>
+  <manvolnum>1</manvolnum>
+  <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+  <refname>gtk4-encode-symbolic-svg</refname>
+  <refpurpose>Symbolic icon conversion utility</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-encode-symbolic-svg</command>
+<arg choice="opt">OPTION...</arg>
+<arg choice="plain"><replaceable>PATH</replaceable></arg>
+<arg choice="plain"><replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+  <command>gtk4-encode-symbolic-svg</command> converts symbolic svg icons into
+  specially prepared png files. GTK+ can load and recolor these pngs, just like
+  original svgs, but loading them is much faster.
+</para>
+<para>
+  <replaceable>PATH</replaceable> is the name of a symbolic svg file,
+  <replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable> are the
+  desired dimensions for the generated png file.
+</para>
+<para>
+  To distinguish them from ordinary pngs, the generated files have the extension
+  <filename>.symbolic.png</filename>.
+</para>
+</refsect1>
+
+<refsect1><title>Options</title>
+<variablelist>
+  <varlistentry>
+    <term>-o <replaceable>DIRECTORY</replaceable></term>
+    <term>--output <replaceable>DIRECTORY</replaceable></term>
+    <listitem><para>Write png files to <replaceable>DIRECTORY</replaceable>
+         instead of the current working directory.</para></listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+</refentry>
diff --git a/docs/reference/gtk/gtk4-launch.xml b/docs/reference/gtk/gtk4-launch.xml
new file mode 100644 (file)
index 0000000..6bfc0a1
--- /dev/null
@@ -0,0 +1,74 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-launch">
+
+<refentryinfo>
+  <title>gtk4-launch</title>
+  <productname>GTK+</productname>
+  <authorgroup>
+    <author>
+      <contrib>Developer</contrib>
+      <firstname>Tomáš</firstname>
+      <surname>Bžatek</surname>
+      <email>tbzatek@redhat.com</email>
+    </author>
+  </authorgroup>
+</refentryinfo>
+
+<refmeta>
+  <refentrytitle>gtk4-launch</refentrytitle>
+  <manvolnum>1</manvolnum>
+  <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+  <refname>gtk4-launch</refname>
+  <refpurpose>Launch an application</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-launch</command>
+<arg choice="opt" rep="repeat">OPTION</arg>
+<arg choice="plain">APPLICATION</arg>
+<arg choice="opt" rep="repeat">URI</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+<command>gtk4-launch</command> launches an application using the given name.
+The application is started with proper startup notification on a default
+display, unless specified otherwise.
+</para>
+<para>
+<command>gtk4-launch</command> takes at least one argument, the name of
+the application to launch. The name should match application desktop file name,
+as residing in /usr/share/application, with or without the '.desktop' suffix.
+</para>
+<para>
+If called with more than one argument, the rest of them besides the application
+name are considered URI locations and are passed as arguments to the launched
+application.
+</para>
+</refsect1>
+
+<refsect1><title>Options</title>
+  <para>The following options are understood:</para>
+  <variablelist>
+    <varlistentry>
+    <term><option>-?</option>, <option>--help</option></term>
+      <listitem><para>Prints a short help text and exits.</para></listitem>
+    </varlistentry>
+  </variablelist>
+  <variablelist>
+    <varlistentry>
+    <term><option>--version</option></term>
+      <listitem><para>Prints the program version and exits.</para></listitem>
+    </varlistentry>
+  </variablelist>
+</refsect1>
+
+</refentry>
diff --git a/docs/reference/gtk/gtk4-query-settings.xml b/docs/reference/gtk/gtk4-query-settings.xml
new file mode 100644 (file)
index 0000000..1702bcd
--- /dev/null
@@ -0,0 +1,45 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-query-settings">
+
+<refentryinfo>
+  <title>gtk4-query-settings</title>
+  <productname>GTK+</productname>
+  <authorgroup>
+    <author>
+      <contrib>Developer</contrib>
+      <firstname>Timm</firstname>
+      <surname>Bäder</surname>
+    </author>
+  </authorgroup>
+</refentryinfo>
+
+<refmeta>
+  <refentrytitle>gtk4-query-settings</refentrytitle>
+  <manvolnum>1</manvolnum>
+  <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+  <refname>gtk4-query-settings</refname>
+  <refpurpose>Utility to print name and value of all GtkSettings properties</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-query-settings</command>
+<arg choice="opt"><replaceable>PATTERN</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+  <command>gtk4-query-settings</command> prints both name and value of all properties
+  available in the GtkSettings class. Optionally, you can filter which properties
+  to list by specifying a PATTERN.
+</para>
+</refsect1>
+
+</refentry>
diff --git a/docs/reference/gtk/gtk4-update-icon-cache.xml b/docs/reference/gtk/gtk4-update-icon-cache.xml
new file mode 100644 (file)
index 0000000..8f6409e
--- /dev/null
@@ -0,0 +1,123 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk4-update-icon-cache">
+
+<refentryinfo>
+  <title>gtk4-update-icon-cache</title>
+  <productname>GTK+</productname>
+  <authorgroup>
+    <author>
+      <contrib>Developer</contrib>
+      <firstname>Matthias</firstname>
+      <surname>Clasen</surname>
+    </author>
+  </authorgroup>
+</refentryinfo>
+
+<refmeta>
+  <refentrytitle>gtk4-update-icon-cache</refentrytitle>
+  <manvolnum>1</manvolnum>
+  <refmiscinfo class="manual">User Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+  <refname>gtk4-update-icon-cache</refname>
+  <refpurpose>Icon theme caching utility</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>gtk4-update-icon-cache</command>
+<arg choice="opt">--force</arg>
+<arg choice="opt">--ignore-theme-index</arg>
+<group>
+  <arg choice="plain">--index-only</arg>
+  <arg choice="plain">--include-image-data</arg>
+</group>
+<arg choice="opt">--source <arg choice="plain"><replaceable>NAME</replaceable></arg></arg>
+<arg choice="opt">--quiet</arg>
+<arg choice="opt">--validate</arg>
+<arg choice="plain"><replaceable>PATH</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+  <command>gtk4-update-icon-cache</command> creates mmapable cache
+  files for icon themes.
+</para>
+<para>
+  It expects to be given the <replaceable>PATH</replaceable> to a icon theme
+  directory containing an <filename>index.theme</filename>, e.g.
+  <filename>/usr/share/icons/hicolor</filename>, and writes a
+  <filename>icon-theme.cache</filename> containing cached information about
+  the icons in the directory tree below the given directory.
+</para>
+<para>
+  GTK+ can use the cache files created by <command>gtk4-update-icon-cache</command>
+  to avoid a lot of system call and disk seek overhead when the application
+  starts. Since the format of the cache files allows them to be mmaped
+  shared between multiple applications, the overall memory consumption is
+  reduced as well.
+</para>
+</refsect1>
+
+<refsect1><title>Options</title>
+<variablelist>
+  <varlistentry>
+    <term>--force</term>
+    <term>-f</term>
+    <listitem><para>Overwrite an existing cache file even if it appears to be
+         uptodate.</para></listitem>
+  </varlistentry>
+
+  <varlistentry>
+    <term>--ignore-theme-index</term>
+    <term>-t</term>
+    <listitem><para>Don't check for the existence of <filename>index.theme</filename>
+     in the icon theme directory. Without this option, <command>gtk4-update-icon-cache</command>
+     refuses to create an icon cache in a directory which does not appear to
+     be the toplevel directory of an icon theme.
+    </para></listitem>
+  </varlistentry>
+
+  <varlistentry>
+    <term>--index-only</term>
+    <term>-i</term>
+    <listitem><para>Don't include image data in the cache.
+    </para></listitem>
+  </varlistentry>
+
+  <varlistentry>
+    <term>--include-image-data</term>
+    <listitem><para>Include image data in the cache.
+    </para></listitem>
+  </varlistentry>
+
+  <varlistentry>
+    <term>--source</term>
+    <term>-c</term>
+    <listitem><para>Output a C header file declaring a constant
+     <replaceable>NAME</replaceable> with the contents of the icon
+     cache.</para></listitem>
+  </varlistentry>
+
+  <varlistentry>
+    <term>--quiet</term>
+    <term>-q</term>
+    <listitem><para>Turn off verbose output.
+    </para></listitem>
+  </varlistentry>
+
+  <varlistentry>
+    <term>--validate</term>
+    <term>-v</term>
+    <listitem><para>Validate existing icon cache.
+    </para></listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+</refentry>
index 92c2af2dee2cb3bd6020c33ce3cf9aab91b81e57..9c481dc0357fe7f43493da2f54d6317f0ad162e7 100644 (file)
@@ -1553,11 +1553,11 @@ endif
 #
 bin_PROGRAMS = \
        gtk4-query-immodules    \
-       gtk-update-icon-cache \
-       gtk-encode-symbolic-svg \
-       gtk-builder-tool \
-       gtk-query-settings \
-       gtk-launch
+       gtk4-update-icon-cache \
+       gtk4-encode-symbolic-svg \
+       gtk4-builder-tool \
+       gtk4-query-settings \
+       gtk4-launch
 
 gtk4_query_immodules_SOURCES = queryimmodules.c gtkutils.c
 gtk4_query_immodules_LDADD =           \
@@ -1567,32 +1567,32 @@ gtk4_query_immodules_LDADD =            \
        $(GMODULE_LIBS)                         \
        $(GTK_DEP_LIBS)
 
-gtk_update_icon_cache_SOURCES = updateiconcache.c
-gtk_update_icon_cache_LDADD = $(GDK_PIXBUF_LIBS)
+gtk4_update_icon_cache_SOURCES = updateiconcache.c
+gtk4_update_icon_cache_LDADD = $(GDK_PIXBUF_LIBS)
 
-gtk_encode_symbolic_svg_SOURCES = encodesymbolic.c
-gtk_encode_symbolic_svg_LDADD =                        \
+gtk4_encode_symbolic_svg_SOURCES = encodesymbolic.c
+gtk4_encode_symbolic_svg_LDADD =                       \
        $(GDK_PIXBUF_LIBS)                      \
        $(top_builddir)/gdk/libgdk-4.la         \
        $(top_builddir)/gsk/libgsk-4.la         \
        $(GTK_DEP_LIBS)
 
-gtk_builder_tool_SOURCES = gtk-builder-tool.c
-gtk_builder_tool_LDADD =                       \
+gtk4_builder_tool_SOURCES = gtk-builder-tool.c
+gtk4_builder_tool_LDADD =                      \
        libgtk-4.la                             \
        $(top_builddir)/gdk/libgdk-4.la         \
        $(top_builddir)/gsk/libgsk-4.la         \
        $(GTK_DEP_LIBS)
 
-gtk_query_settings_SOURCES = gtk-query-settings.c
-gtk_query_settings_LDADD=                      \
+gtk4_query_settings_SOURCES = gtk-query-settings.c
+gtk4_query_settings_LDADD=                     \
        libgtk-4.la                             \
        $(top_builddir)/gdk/libgdk-4.la         \
        $(top_builddir)/gsk/libgsk-4.la         \
        $(GTK_DEP_LIBS)
 
-gtk_launch_SOURCES = gtk-launch.c
-gtk_launch_LDADD =                             \
+gtk4_launch_SOURCES = gtk-launch.c
+gtk4_launch_LDADD =                            \
        libgtk-4.la                             \
        $(top_builddir)/gdk/libgdk-4.la         \
        $(top_builddir)/gsk/libgsk-4.la         \